getAuthToken

Returns an authorization token that is needed if the MusicMaster CS, Enterprise Configuration option for NexusAuthRequired is set to True.

Sample Request

<mmRequest command="getAuthToken" client="NexusTest 1.0" userData="hello">
	<contents>	
		<username>ActualUsername</username>
		<password>ActualPassword</password>	
	</contents>
</mmRequest>

Request Notes

If authorization is required, you include the token in the header of the Nexus message.

<mmRequest command="getCategoryList" station="MMCS - FM" client="NexusTest 1.0" userData="hello" authToken="5716c935-0263-4f76-aaba-8c301ec3969e"/>

The authorization token is good for a limited time. When it has expired, you must request a new one.

Sample Reply

<mmReply command="getAuthToken" version="1" userData="hello" status="ok">
	<contents>
		<username>ActualUsername</username>
		<password>ActualPassword</password>
		<authToken>5716c935-0263-4f76-aaba-8c301ec3969e</authToken>
		<expiration>2016-07-12T15:28:47</expiration>
	</contents>
</mmReply>

Please see destroyAuthToken to destroy the AuthToken when you are done with it.

Compatibility and Version Info

Available in MusicMaster CS 1.0